home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / dev / c / cweb31p9d.lha / CWeb / cweb31.readme < prev    next >
Text File  |  1994-07-08  |  4KB  |  67 lines
  1. Short: Literate programming discipline for C.
  2. Type: dev/c or dev/misc
  3. Uploader: Andreas Scherer
  4. Authors: Silvio Levy and Donald Knuth
  5.  
  6. This  is  the  portability  implementation  of  Silvio Levy's and Donald E.
  7. Knuths's  CWEB  system, version 3.1 of November 1993, compiled and provided
  8. with  changefiles  for  ANSI-C,  TURBO-C,  and  SAS/C 6.x and makefiles for
  9. UNIX-make,  TURBO-make  and  smake  by Andreas Scherer.  It is based on the
  10. CWEB  3.1  port by Tomas Willis and the CWEB 2.8 port by Carsten Steger and
  11. the  CWEB-p  3.0  distribution  by  Hans-Hermann Bode and Klaus Guntermann,
  12. including  all features of the original UNIX implementation like ANSI-C and
  13. C++  support,  full ASCII input capability, and more, plus all enhancements
  14. made in these AMIGA, MSDOS and UNIX ports plus some special features like:
  15.  
  16.    - The complete source code is capable of being recompiled with SAS/C for
  17.      AMIGADOS, with  GCC and TURBOC for  MSDOS, and with  CC, C89, and  GCC
  18.      for UNIX without the need for further changes.
  19.  
  20.    - The `gcwebmac.tex' macro package  activated by setting the `+g' option
  21.      includes support for  special characters like  German umlauts and some
  22.      frequently  used  specials  according  to  ISO 8859-1/ECMA-94, IBM  PC
  23.      International Codepage 850, Macintosh 8-bit font table and HP Roman 8.
  24.      All captions used by CWEB are translated to German in this macro file.
  25.  
  26.    - There  are  TeX macro  files `ecma94.tex', `hp8.tex', `mac8.tex',  and
  27.      `pc850.tex' for  support  of  extended  code  tables.   Also  included
  28.      are  `ecma94.w',  `hp8.w',  `mac8.w',  and  `pc850.w' with appropriate
  29.      transliteration tables.
  30.  
  31.    - Two  AREXX  scripts for use with the CygnusEd Professional Editor were
  32.      added to this package, one for CTANGLE and CWEAVE, localized in German
  33.      and English under AMIGADOS version 2.1 or 3.0,  the other for use with
  34.      the SAS/C 6.x compiler in connection with CED version 3.5.
  35.  
  36.    - Both  CTANGLE and  CWEAVE are localized in German and English with the
  37.      help of the `locale.library' of AMIGADOS 2.1/3.0.  Catalogs  for other
  38.      languages can easily be added.  A set of German strings is provided.
  39.  
  40.    - An algorithm for recursive `@i'nclude file search was adapted from the
  41.      TeX and METAFONT implementation.
  42.  
  43.    - The `o' option  as described in `cwebman.tex' was added  in connection
  44.      with the `i' option by Steger.
  45.  
  46.    - Four additional CWEB example programs are included as examples for the
  47.      portability between PASCAL-WEB and C-CWEB and for the usage of the C++
  48.      features of version 3.1.
  49.  
  50.    - All three system programs support the `version' information command.
  51.  
  52.    - Both CTANGLE and CWEAVE are compiled in the NEAR  data segment and can
  53.      be made resident.
  54.  
  55.    - The `m' option enables ARexx communication between  CWEB and the SAS/C
  56.      message browser SCMSG.  Any warnings or error messages are transferred
  57.      to its list  window.  The behaviour of  this feature can be controlled
  58.      via  the  external  environment variable SCMSGOPT, which may be set to
  59.      any legal option string as described in the documentation to the SAS/C
  60.      development system by SAS Institute.
  61.  
  62. This port was done and completely tested with SAS/C version 6.3 and SAS/C++
  63. 6.51 on the AMIGA.  After completion the package was ported to various UNIX
  64. systems  with  CC, C89, and GCC, and to MSDOS with TURBO-C++ 3.1.  Provided
  65. that  all these ports work successfully, I am quite sure that all bugs have
  66. been found and fixed.
  67.